home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / printer / etext302.zip / COMPILE.DOC < prev    next >
Text File  |  1996-03-27  |  40KB  |  771 lines
  1.  
  2.  
  3.                    THE ELECTRONIC TEXT PUBLISHING SYSTEM (tm)
  4.  
  5.  
  6.         Description:
  7.  
  8.         The Electronic  Text Publishing  System (or  "E-Text" for short)
  9.         is  used  to  make  "electronic"  books  or  magazines,  such as
  10.         tutorials, training manuals, or  even works of literature.   The
  11.         E-Text  system  allows  you   to  create  professional   looking
  12.         programs with little  effort.   E-Text uses text files that  you
  13.         create and compiles  them into a  menu driven "electronic" book,
  14.         complete with a  table of contents.   If you know  how to use  a
  15.         word  processor,  then  you  have  all  the  skills necessary to
  16.         publish your own "electronic" books  on a disk.  The  electronic
  17.         books that  you create  with E-Text  can be  copied, distributed
  18.         and sold, royalty  free.  Share  your knowledge, research,  your
  19.         works of poetry, fiction, or your sales products with others  by
  20.         using E-Text!
  21.  
  22.  
  23.         Features:
  24.  
  25.         E-Text allows you to customize nearly every aspect of your
  26.         finished catalog.  Consider the following...  E-Text allows you
  27.         to...
  28.  
  29.         + Create a "Table of Contents" (Main menu)
  30.  
  31.         + Customize the size and location of the Main Menu
  32.  
  33.         + Customize the attributes of the Main Menu, such as colors,
  34.           border frame, elevator bar, drop shadow, etc.
  35.  
  36.         + Define the colors of each screen.
  37.  
  38.         + Use background wallpaper to create eye-catching screens.
  39.  
  40.         + Invoke screen special effects - for example, screen wipes
  41.           from left to right, right to left, top to bottom, opening
  42.           curtains, splits, clock sweeps, etc.
  43.  
  44.         + Run DOS commands, execute batch files or other programs.
  45.           E-Text can be used to create your own program menus or shell.
  46.  
  47.         + Consolidates all your .TXT files into just one compact data
  48.           file.  In fact, after compilation, only two files are
  49.           necessary to make your electronic book available to your
  50.           audience (READ.EXE and READ.DAT).  This makes disk
  51.           distribution file management a breeze.
  52.  
  53.         + Display 256 color .PCX graphic images (Pro version only).
  54.  
  55.         + Include sub-menus within your Main Menu (Pro version only).
  56.  
  57.  
  58.         Special requirements:
  59.  
  60.         No special system requirements or hardware is required to use
  61.         E-Text except a DOS version greater or equal to version 3.0.
  62.         A hard disk does make the compilation process much easier and
  63.         faster, however.
  64.  
  65.  
  66.         Before we get started:
  67.  
  68.         If you obtained E-Text through a shareware vendor, or BBS, or
  69.         CD-ROM, make sure that no files are missing.  A file called
  70.         VENDINFO.DIZ contains a listing of all the files required to run
  71.         E-Text.  If you have problems with E-Text, check the files that
  72.         you have obtained with the VENDINFO.DIZ listing.  If you find
  73.         files missing, please notify your vendor, or BBS sysop, or feel
  74.         free to contact the author via our 24-hour BBS at (540)
  75.         372-9680 N-8-1 ANSI.  The latest version can always be
  76.         downloaded from our BBS as ETEXT*.ZIP in the PKSOFT directory.
  77.  
  78.         Before you compile your very own electronic book we recommend
  79.         that you browse through one that has already been created.  You
  80.         should find a file AESOP.DAT on your disk, which contains a
  81.         short collection of Aesop's Fables.  To view this electronic
  82.         book from the DOS prompt enter: READ AESOP   then press
  83.         [ENTER].  Browse through this electronic book and get a feel for
  84.         what E-Text can do.  If you like what you see, and would like
  85.         to create similar e-text documents, resume reading these
  86.         instructions and proceed with your first compilation.
  87.  
  88.  
  89.         Terms and definitions:
  90.  
  91.         There are several terms that will be used throughout this
  92.         documentation and that need to be fully understood by the user
  93.         before you create your own electronic books.  Please review
  94.         these definitions carefully:
  95.  
  96.         ASCII FILE: This is a term used to describe any file that you
  97.         create and save with an editor such as DOS' EDIT or Window's
  98.         Notepad.  An ASCII file contains only characters that can be
  99.         found on a standard IBM keyboard.  Most word processor programs
  100.         (like Word Perfect) can save files in ASCII format IF you know
  101.         how to.  E-Text does NOT come with an editor because most users
  102.         already have a favorite text editor or word processor that they
  103.         feel comfortable with.  We saw no reason to force the user to
  104.         use another editor and have consequently not included one.
  105.  
  106.         CHAPTER: A chapter is any ASCII .TXT file that you create that
  107.         you want to become part of your electronic book.  Each
  108.         selection from the Main Menu "Table of Contents" is considered a
  109.         chapter.
  110.  
  111.         COMPILER: The compiler is the program  that gathers all  of
  112.         your ASCII chapter text files (*.TXT), and binary wallpaper
  113.         files (*.BIN) together, and prompts you step by step for
  114.         specific details about how you want your final electronic book
  115.         to look (screen colors, Table of Contents (Main Menu) size,
  116.         location, shadows, etc.  The compiler merges and can compress
  117.         this information into a single data file (READ.DAT).
  118.  
  119.         DATA FILE:  The data file is a specially formatted file that
  120.         contains ALL of your chapters, wallpaper, and screen
  121.         definitions.  This data file is created by using the E-Text
  122.         compiler (COMPILE.EXE), and once it has been created it can be
  123.         identified by the default filename "READ.DAT".  This data file
  124.         is one of the two necessary files that must be placed on your
  125.         distribution disk in order for others to read your electronic
  126.         book.  Data files can be renamed if you wish, however to use
  127.         them with the "reader" you must specify its new file name on
  128.         the DOS command line.  For example, AESOP.DAT was originally
  129.         named READ.DAT, but was renamed in order to preserve its
  130.         contents from future compilations that would have created a new
  131.         READ.DAT file and overwritten it.  In order to use AESOP.DAT
  132.         with the "reader", the user needs to start the electronic book
  133.         from the DOS command line in this manner: READ AESOP.DAT   By
  134.         using this method inside a batch file, the author can create
  135.         several electronic books on one floppy disk, needing only one
  136.         "reader".
  137.  
  138.         READER MODULE:  This refers to the file "READ.EXE".  This is
  139.         the program that reads the information in your data file and
  140.         displays it to your audience.  Remember, in order to create an
  141.         electronic book for distribution on a floppy diskette, two
  142.         files must exist on that disk: 1) READ.EXE and 2) READ.DAT.
  143.  
  144.         TEXT FILE:  Text files and ASCII files all refer to the
  145.         same thing (see ASCII FILE above).
  146.  
  147.         WALLPAPER: If you have never used Microsoft Windows, then the
  148.         term "wallpaper" may conjure up ideas of colored paper and
  149.         wheat paste.  With E-Text, however, wallpaper refers to
  150.         background screen designs that can be used to liven up your
  151.         electronic book.  Wallpaper files should end with a .BIN file
  152.         extension.  How do you create wallpaper files?  When you
  153.         register E-Text you will be sent, as a bonus, the E-Text Screen
  154.         Composer program that allows you to create your own wallpaper
  155.         files.  Several wallpaper .BIN files have been included with
  156.         the evaluation copy, so feel free to use them.  You may also
  157.         use any text screen design program that generates BLOADable
  158.         binary files.  The "Laughing Dog Screen Maker" and "The Draw"
  159.         are two popular shareware screen designers that can also create
  160.         wallpaper files.  You can find these programs on most